Validate S5’,ISS MAC

Command:

To validate an S5’,ISS Message Authentication Code (MAC) which provides the Issuer with the ability to verify the integrity of a non-CEP transaction.

Notes:

Use of this command requires the optional ESP licence. Error code 67 will be returned if the command is not licensed.

 

Field

Length & Type

Details

COMMAND MESSAGE

Message Header

m A

Will be returned to the host unchanged

Command Code

2 A

Value “W8”

KIS5’

  

32 H

S5’ Issuer Key, encrypted under variant 4 of LMK pair 20-21

ALGKS

1 B

Algorithm code for S5’ transactions; must equal X’01

NTPSAM

4 B

PSAM transaction number

MAC Type

1 B

MAC type; must equal X’01 or X’02

MTOT

4 B

MTOToldIB or MTOTAGG

CURRPDA

3 B

PDA currency

NT

2 B

NToldIB or NTAGG

IDBATCH

2 B

Identifier of batch containing the aggregated transactions

RIDPSAM

  

5 B

Registered identity of the entity assigning PSAM Creator IDs

IDPSAMCREATOR

4 B

Identifier for the creator of a PSAM

IDPSAM

4 B

Identifier of a PSAM

S5’,ISS

8 B

Transaction MAC, to be validated

End Message Delimiter

1 C

  

Optional. Must be present if a message trailer is present. Value X'19

Message Trailer

n A

Optional. Maximum length 32 characters

 


 

Field

Length & Type

Details

RESPONSE MESSAGE

Message Header

m A

Will be returned to the host unchanged

Response Code

2 A

Value “W9”

Error Code

2 N

00 - No error

01 – S5’,ISS verification failure

02 – Invalid ALGKS

03 – Invalid MAC type

10 – KIS5’ parity error

12 - No keys loaded in user storage

13 - LMK error – report to Supervisor

15 - Error in input data

21 - Invalid user storage index

End Message Delimiter

1 C

  

Will only be present if present in the command message. Value X'19

Message Trailer

n A

  

Will only be present if in the command message. Maximum length 32 characters